{{tag>oneiric precise quantal openstreetmap}}
----
{{ http://josm.openstreetmap.de/svn/trunk/images/logo.png?75|}}

====== Éditeur Java pour OpenStreetMap ======

[[http://josm.openstreetmap.de/|Java OpenStreetMap Editor]], **JOSM** en abrégé, est un éditeur [[:java]] pour la [[:cartographie]] collaborative libre sur [[http://www.openstreetmap.org/|OpenStreetMap]] (OSM).

===== Installation =====

La version de JOSM présente dans les dépôts officiels d'Ubuntu n'est pas tenue à jour autant qu'il le faudrait...\\
Notamment pour des raisons de compatibilité avec les greffons (plugins), il est recommandé d'utiliser la dernière version disponible sur le site officiel.

==== Pré-requis ====

  * Avoir un environnement [[:java]] fonctionnel.

==== Avec les dépôts d'OpenStreetMap ====

OpenStreetMap propose un dépôt pour Ubuntu permettant de récupérer et de tenir à jour JOSM.

  - [[:tutoriel:comment_modifier_sources_maj|Modifiez vos sources de mises à jour]] pour y ajouter le dépôt d'OpenStreetMap -- **Attention** à bien remplacer <VERSION_UBUNTU> par le nom de votre version en minuscule ([[:Oneiric|oneiric]], [[:Precise|precise]], [[:Quantal|quantal]]) : <file>deb http://josm.openstreetmap.de/apt <VERSION_UBUNTU> universe</file>
  - Téléchargez et installez la clé d'authentification du dépôt : <code>wget -q http://josm.openstreetmap.de/josm-apt.key -O- | sudo apt-key add -</code>
  - [[:tutoriel:comment_modifier_sources_maj#recharger_la_liste_des_paquets|Rechargez la liste des paquets]] ;
  - [[:tutoriel:comment_supprimer_un_paquet|Supprimez les paquets]] **josm** et **josm-plugins** (si vous les aviez précédemment installés) ;
  - [[:tutoriel:comment_installer_un_paquet|Installez les paquets]] **[[apt>josm|josm]]** ou **[[apt>josm-latest|josm-latest]]** pour la version en développement.

<note tip>Vous pouvez automatiser l'ajout du dépôt avec sa clé d'authentification et la mise à jour de la liste des paquets avec la commande suivante : <code>echo "deb http://josm.openstreetmap.de/apt `lsb_release -sc` universe #JOSM" | sudo tee -a /etc/apt/sources.list && wget -q http://josm.openstreetmap.de/josm-apt.key -O- | sudo apt-key add - && sudo apt-get update</code>

Il ne vous reste ensuite plus qu'à choisir la version de JOSM qui vous intéresse !</note>

==== Manuelle ====

L'installation manuelle consiste en un téléchargement de l'archive Java sur le site officiel et, éventuellement, en la création d'un raccourci dans le menu application. Les archives Java disponibles sur le site officiel sont identiques à celles des dépôt d'OpenStreetMap. Une installation manuelle n'a donc de sens que si vous n'avez pas les droits d'administration sur la machine sur laquelle vous souhaitez utiliser JOSM...

  - Télécharger l'archive Java
    * Dernière version stable : [[http://josm.openstreetmap.de/josm-tested.jar|josm-tested.jar]] ;
    * Dernière version en développement : [[http://josm.openstreetmap.de/josm-latest.jar|josm-latest.jar]].
  - [[:permissions|Modifiez les permissions]] pour rendre l'archive exécutable.

=== Lancer JOSM ===

Vous pouvez lancer JSOM en [[terminal#comment_ouvrir_un_terminal|ouvrant un terminal]] et en tapant les commandes suivantes :
<code>cd ~/<dossier_dans_lequel_se_trouve_l_archive_de_josm>
java -jar josm-tested.jar</code>

=== Ajout du raccourci dans le menu ===

Il est possible de créer un raccourci à intégrer dans le menu d'application. Dans les explications qui suivent, c'est **la version stable** de JOSM qui est utilisée avec l'archive **josm-tested.jar**.\\
**Adaptez le nom du fichier** si vous utilisez la version en développement contenue dans l'archive **josm-latest.jar** :!:

  * **Sous Gnome :**
    - Dans //Système -> Préférences -> **Menu Principal**// ;
    - Ajoutez un raccourcis dans //Application -> **Éducation**// ;
      * Nom : //JOSM//
      * Commande : //java -jar /**<emplacement_de_l_archive_de_josm>**/josm-tested.jar//
  * **Sous KDE 4.2 :**
    - Ouvrez l'éditeur de menu avec le bouton droit de la sourie sur l'icône du menu K ;
    - Ajoutez un raccourcis dans //Éducation -> **Science**// ;
      * Nom : //JOSM//
      * Commande : //java -jar /**<emplacement_de_l_archive_de_josm>**/josm-tested.jar//

===== Mettre à jour JOSM =====

<note tip>Si vous avez fait une installation [[:josm#avec_les_depots_d_openstreetmap|avec les dépôt d'OpenStreetMap]], la mise est jour est automatique.</note>

Dans le cas d'une installation manuelle, vous pouvez mettre JOSM à jour afin de disposer de la dernière version disponible sur [[http://josm.openstreetmap.de/|le site officiel]] en remplaçant simplement l'archive téléchargée. Attention à conserver le même nom de fichier pour l'archive (josm-tested.jar par défaut pour la version stable) afin de ne pas briser le raccourci mis en place dans le menu application.

===== Installation de greffons =====

Parmi les greffons (plugins) intéressants, on notera cadastre-fr, WMSplugins et validator qui permettent respectivement d'afficher en arrière-plan les données cadastrales françaises, des vues satellites et la correction de données incorrectes.

<note important>L'utilisation de cadastre demande une modification de la projection. Consultez impérativement les sites indiqués en fin de cette page pour savoir comment l'utiliser.</note>

==== Installation automatique ====

  * Appuyez sur la touche F12 pour afficher la fenêtre de configuration ;
  * Ouvrez le menu des greffons (celui dont l'icône est une prise électrique) ;
  * Cliquez sur "Télécharger la liste" puis sur "Actualiser" ;
  * Sélectionnez les greffons à installer ;
  * Validez puis relancez JOSM.

==== Installation manuelle ====

  * Téléchargez les greffons souhaités à partir de [[http://josm.openstreetmap.de/wiki/Plugins]]
  * Enregistrez les fichiers .jar obtenus dans le répertoire ///home/<votre_nom_utilisateur>/.josm/plugins// ;
  * Lancez JOSM, si besoin, activez les plugins dans la fenêtre des préférences et relancez JOSM.

===== Liens externes =====

  * Site officiel de JOSM : http://josm.openstreetmap.de/ **(en)** ;
  * Site officiel de OSM : http://www.openstreetmap.org/ **(en)** ;
  * [[http://wiki.openstreetmap.org/wiki/FR:JOSM|La page consacrée à JOSM]] dans le wiki francophone d'OpenStreetMap **(fr)** ;
  * Présentation et tutoriel sur OSM et les différents outils disponible : http://fr.flossmanuals.net/openstreetmap/ch011_modifier-avec-lediteur-hors-ligne-josm **(fr)** ;
  * Tutoriel sur JOSM et l'utilisation des greffons : http://partir-en-vtt.com/php/articles/voir_article.php?id_article=282 **(fr)** ;
  * Forum de discussion francophone consacré à OSM : http://forum.openstreetmap.fr/ **(fr)**.

----

//Contributeurs :  [[utilisateurs:Spirzouf|Spirzouf]].//